home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / pascal / gpc1.1p2 / gpc1 / usr / src / gpc-1.1p2-2.6.3 / INSTALL < prev    next >
Encoding:
Text File  |  1995-04-20  |  4.8 KB  |  129 lines
  1.        
  2. Last modified: Sat Mar 25 21:27:58 1995
  3.  
  4. For GPC-1.1*
  5. and GCC version 2.6.*
  6.  
  7. This is a short installation quide for the gnu pascal compiler:
  8.  
  9.     0) Unpack gpc snapshot. The file is a GNU Zip compressed
  10.        tar file. The distribution creates a new subdirectory
  11.        named after the GCC version number it is based on,
  12.        and writes the files there, e.g. a directory "2.6.3"
  13.        for gpc version running with GCC 2.6.3.
  14.  
  15.        Note: Earlier snapshots unpacked all files to the current
  16.        directory.
  17.  
  18.     1) compile gcc. It must be the same version as the one GPC is
  19.        implemented with.
  20.  
  21.        Leave the objects in place, since GPC will directly load
  22.        most of the GCC object files.
  23.  
  24.       Install the GNU C compiler. At least install it so that the
  25.       "xgcc" program will be able to locate the libgcc.a file with
  26.       "xgcc --print-libgcc-file-name" command. This is to find
  27.       out where gpc Makefile should put libgpc.a and gpc1.
  28.  
  29.     2) cd to gpc object directory. It should NOT be
  30.        the same as the GPC source directory. You'll need
  31.        a make that understands VPATH variable. GNU Make does.
  32.  
  33.        Gpc will later be integrated to the gcc distribution
  34.        and then will compile like the other GNU compilers.
  35.  
  36.        If you have some kind of magic error during compiltion,
  37.        e.g. some rts/file can not be generated, please use GNU
  38.        make. If you do, and you get errors like that send me mail.
  39.  
  40.     3) In the gpc object directory, run the "configure" program
  41.        from gpc source directory. 
  42.  
  43.        Do not use "--prefix" flag unless you have to. If you do not
  44.        use it, gpc will install itself to the same directory where
  45.        gcc has been installed before.
  46.  
  47.        To make this easy, I use the shell script DOCONF.example to
  48.        configure gpc.
  49.  
  50.        This shell script gives the --gccsrc and --gccdir
  51.        switches to gpc configure program. To use it, you should
  52.        create file GCC-VERSION that contains only the version
  53.        number of gcc (it's used in the pathnames), e.g. 2.6.0
  54.  
  55.        NOTE: Do *not* use absolute path names in gccdir or gccsrc
  56.        symlinks!!!
  57.  
  58.        The configure script then generates a Makefile to your
  59.        current directory from the Makefile.in in the distribution.
  60.  
  61.        Note that the gpc configure script does not want to
  62.        have the usual host-vendor-system spec, since GPC is
  63.        compiled for the same system than GCC was.
  64.  
  65.     4) Say "make -n" to see if everything is ok.
  66.  
  67.     5) After it is, you just say "make" to make the compiler
  68.        and run time system.
  69.       
  70.        NOTE: For alpha OSF/1 v3.2 (GCC 2.6.3):
  71.        If your linker starts to output error messagaes like:
  72.  
  73. Warning: Linking some objects which contain exception information sections
  74.         and some which do not. This may cause fatal runtime exception handling
  75.         problems (last obj encountered without exceptions was <OBJ/LIB>)
  76.  
  77.        I do not know why these started to appear, but you can
  78.        get rid of these if you do as follows in the GPC object
  79.        directory.
  80.  
  81.        You need to trigger the Makefile dependencies, e.g. by
  82.        doing the touch command below. What happens is that it
  83.        re-generates the version.c and rts/version.c files, which
  84.        need to be recompiled with ALPHA_BUG defined.
  85.  
  86.        Example:
  87.         % touch Makefile
  88.         % make MY_CFLAGS=-DALPHA_BUG other-make-flags-you-want-to-use
  89.  
  90.     6) The run time system is quite portable, but I have not
  91.        tested it on a pure System V, and it may require
  92.        some modifications. My current development system is a
  93.        i486 Mach 3.0 + BSD single server.
  94.  
  95.        The rts has been compiled in: aix,osf 1,mach ux,linux,
  96.        ultrix,hp-ux,minix,etc...
  97.  
  98.     7) When everything compiles, you can verify what the 
  99.        "make -n install" command does, and if you are satisfied
  100.        run it without the -n option to install the compiler (gpc1),
  101.        front end (gpc), run time system (libgpc.a) to the same
  102.        place where gcc was installed.
  103.  
  104.        It is sort of stupid to have a separate incarnation
  105.        of gcc.c; the difference now is that "gpc"
  106.        also searches from library "libgpc.a and -lm".
  107.        In addition gcc.c specifies the interface to the
  108.        Pascal compiler (gpc1). This command will vanish when
  109.        "gcc" knows how to compile Pascal programs.
  110.  
  111.     8) While compiling, browse through COPYING, README, GPC.NOTES
  112.        and PROBLEMS to see what you are getting.
  113.  
  114.     9) If you make modifications/bug fixes, please send
  115.        them back to me so that we can make this a better compiler.
  116.  
  117.                         Juki
  118.                         jtv@hut.fi
  119.  
  120. *---------------------------------------------------------------------------*
  121.  jtv@hut.fi                               Jukka Virtanen
  122.  Jukka.Virtanen@hut.fi                    Helsinki University of Technology
  123.  juki@hut.fi                              Computing Centre
  124.                                           SF-02150, Espoo, FINLAND
  125.                           tel. +358 0 4514315
  126.                       Fax. +358 0 464788
  127.  
  128. -----------------------------------------------------------------------------
  129.